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ABSTRACT 


This guide describes the option switches, operating procedures’ and 
error messages used by the PDP-1l Preservation program. 


PRESRV is a stand-alone utility which, when loaded into memory, 
Overwrites any monitor present and begins execution. 


This manual is directed to the system manager or system programmer who 
wishes to use PRESRV to copy information from one storage device to 
another. PRESRV can be used to copy information from and to disk, 
Magnetic tape, cassette and DECtape devices. 


For quick reference to subjects in this guide, use the following list. 


Tf you need to know about See Section 
Bootstrapping PRESRV 3:1 
Copying identical devices 32a 
Transferring in Logical Tape mode 3.2.3 
Transferring information on a TU16 drive 3.2.2 
Verifying the copy operation 3.2.4 
Copying block~structured devices 3.2.6 
Formatting a disk 4.1 
Determining sufficient buffering space 4.2 
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1.0 INTRODUCTION 


The PDP-1l Preservation Program (PRESRV) is a stand-alone program 
which, when loaded from disk or Magnetic tape, overwrites any resident 
Monitor present and begins execution. Thus PRESRV runs independently 
of any operating system. PRESRV copies data from disk to disk, disk 
to magnetic tape, magnetic tape to magnetic tape, and (to restore data 
to its original device) from magnetic tape to disk. 


PRESRV supports two classes of devices: 
1. Tape devices (magnetic tape and cassette), and 
2. Block-structured devices (DECtape and disk). 
Devices supported by PRESRV are listed in Table 1. 


Table 1 
Devices Supported by PRESRV 


Device Mnemonic Device Type 


TA11/TU60 Cassette Tape 
RH11/RP04 and RH70/RP04 Disk Pack Block-structured 
RK11/RK05 Cartridge Disk Block-structured 


RF11/RS11 Fixed Head Disk 

RP11/RP02/RP03 Disk Pack 

RH11/RS03/RS04 and RH70/RS03/RS04 
Fixed Head Disk 

TC11/TU56 DECtape 

RX11/RX01 Floppy Disk 

RH11/TM02/TU16 and RH70/TM02/TU16 
9~track Magnetic Tape 

TM11/TU10 7- or 9-track Magnetic Tape 

and TM11/TS03 9-track Magnetic Tape 


Tape 


Tape 


PRESRV commands are of the form: 
outspec/switch=inspec/switch 
where 
outspec is the output device to which the data is copied. 


/switch is the optional format switch modifying either’ the 
input or output device or both. 


inspec is the input device from which the data was copied. 


PRESRV operates in one of three modes; image mode, logical tape mode 
and FILES-11 mode. 


Block-structured 
Block~structured 
Block~structured 


Block~structured 
Block~structured 
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1.1 Image Mode 


When copy operations are performed in image mode, output format is 
identical to input format. In image mode, PRESRV assumes no knowledge 
of the input device structure and copies all physical blocks, whether 
in use or not, onto the output device. For example, PRESRV reads all 
blocks on DKO: and copies them to DKl1l:. PRESRV can copy volumes 
containing multiple files and files stored on multiple volumes. If 
the input and output devices are identical, the copy operation is 
automatically performed in image mode unless the user specifies a 
format switch. 


In image mode explicitly, PRESRV separates each file with an 
End-Of-File (EOF) tape mark. When copying information from magnetic 
tape to another tape device, PRESRV assumes the input and output 
volumes are correctly positioned at the load point or positioned after 
an EOF tape mark. After writing each file, PRESRV writes two EOF tape 
marks and then positions the volume between the two EOF tape marks for 
any additional processing. 


If a filelabel is specified when copying information from magnetic 
tape, PRESRV rewinds the input volumes and searches for the specified 
file. A filelabel is a name given to a file written to a _ logical 
tape. If no filelabel is specified, PRESRV assumes the tape is 
properly positioned (at the load point for the first file or between 
two EOF tape marks for subsequent files) and takes the next file on 
the tape as input. 


NOTE 


1. Filelabels, bootstraps, and system 
images are always written at 800 bits 
per inch (bpi). Logical tapes written 
with the /PE switch (which writes TU16 
Magnetic tape volumes at 1600 bpi), 
therefore, cannot be copied in image 
mode. 


2. Logical tapes written on a TU10, TU16, 
or TS03 are bootable interchangeably on 
any of the’ three Magtape devices; 
however, 1600 bpi TU16 tapes are not 
readable on a TU10 or TSO3. 


PRESRV can copy multi-volume files; however, no new file can begin on 
the second or subsequent volume of a multi-volume file. 


1.2 Logical Tape Mode 


In logical tape mode, PRESRV copies information from a disk or 
Magnetic tape onto a magnetic tape. In this mode PRESRV copies a core 
image of itself preceding all data records. This image permits PRESRV 
to be bootstrapped from any device containing information to be 
loaded. A logical tape consists of a label block, a bootstrap block, 
a PRESRV image (first volume only) followed by preserved data. See 
Figure 1 for an example of logical tape format. Subsequent volumes 
contain a label block and a dummy bootstrap block followed by data of 
a file started on the first volume. 
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Only one label 
allowed on sub- 


| [ sequent volumes. 
agg BPr LABEL BLOCK 256 words iMvet be cont tins 
ation of file 
806 : 
LABEL BLOCK started on first 
BPI 
volume.) 
89% BPI BOOTSTRAP BLOCK . 256 words 
802 BPI PRESRV IMAGE xx words DUMMY BOOTSTRAP . 
BLOCK 
8 or 
ap 822 
1698 BPI or 
16228 
BPI 
End of File ERO 
Indicator EOF oF 
EOV 
multiple 
PI B 
802 B LABEL BLOCK yeaa senouene 
first volume VOLUME (S) 
DUMMY BOOTSTRAP 
BLOCK 
828 or 
168% BPI 
Logical BOE 
End of Tape 
EOF 
End of EOV 
Volume 


FIRST VOLUME 


Figure 1 Logical Tape Format 
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Bootstrapping the first volume of a logical tape starts PRESRV, so 
that the contents of the logical tape may be copied to another device 
if desired. When a physical or logical tape is produced by PRESRV, 
the user may specify a filelabel of 1 to 12 characters for the image 


to be produced. See Figure 2 for an example of a logical tape label 
block. 


12 characters maximum 


Source Device 


Source Unit 


Blocks per record 


512 characters per block 


Date of creation (set by /TIM switch) 


Time of creation (set by /TIM switch) 


4 bytes reserved 


Size of PRESRV image (in 256-word blocks) 


Figure 2 Logical Tape Label Block 
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Tape devices (magnetic tape and cassette) are defaulted to logical 
tape mode with the following exceptions: when input and output 
devices are identical, PRESRV copies in image mode unless the user 
specifies a format switch. Also, the output is written in logical 
tape mode when the output device type differs from the input device 
type. For example, if an RKO5 disk cartridge is copied to an RPO4 
disk pack, the pack is written in logical tape mode. 


1.3 FILES~11 Mode 


FILES~-11 is the disk structure used by RSX-11M, RSX-11D and IAS. In 
FILES-1l1 mode, PRESRV copies only blocks in use. Thus FILES-l1l mode 
assumes knowledge of the disk file structure, whereas, image mode and 
logical tape mode do not. FILES-1l information blocks are allocated 
to files and include the files themselves. Blocks not allocated to 
files are not copied. If PRESRV is operating in FILES-11l mode and the 
input device is not in FILES-11] format, PRESRV prints the message: 


STORAGE BITMAP FILES READ ERROR 
Retype the command to specify image mode. 


Block-structured devices (DECtape and disk) are always assumed to be 
in FILES-11 format except when: 


l. Input is a disk or DECtape and output is also a 
block-structured device different from the input and without 
a modifying format switch. In this case, the output is 
defaulted to logical tape format. For example, the command 
string 


PRE>DTO:STEVE=DKO: 
creates a file (STEVE) on DTO: in logical tape mode rather 
than in FILES-1ll mode. (The filelabel on the output device 
is required.) This choice was made because the typical copy 
Operation between non-identical media is done to create 


backup copies of the system. The resulting output, being in 
logical tape format, contains a bootable image of PRESRV on 


2. Both input and output devices are the same type and neither 
is modified by a format switch. In this case, the copy 
Operation is automatically performed in image mode. 


2.0 PRESRV SERVICES 


After the user bootstraps PRESRV and types a command, PRESRV can 
perform the following services: 


1. Make image copies of volumes, 

2. Make copies of volumes in logical tape mode, 

3. Format RKO5, RPO2, RPOQ3 and RPO4 disks, 

4. List labels from volumes in logical tape mode, and 


5. Make copies of volumes in FILES-11l mode. 
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3.0 USING PRESRV 


3.1 Bootstrapping PRESRV 


To run PRESRV, mount the device to be copied and bootstrap the device 
on which PRESRV is recorded. 


When PRESRV is bootstrapped, it displays an identification message of 
the form: 


RSX-11S VOl BL12 

VOLUME PRESERVATION PROGRAM- V02.1 
FOR HELP TYPE /HE 

nn. BLOCKS AVAILABLE FOR BUFFERING 


PRE> 


PRESRV is built as a task running under the RSX-11S Executive and thus 
displays the version of the stand-alone executive in use, the version 
number of PRESRV, and the number of 256(10)-word blocks (nn.) 
available for buffering. The user must use the number of blocks 
available for buffering (displayed in the identification message) to 
determine if a given PRESRV media copy has sufficient buffering space. 


If the total space required for input, output and verification 
(optional) buffers is greater than nn. blocks, PRESRV responds with 
the following message: 


INSUFFICIENT BUFFER SPACE 
Abort or retry the operation. 


By typing the /HE command the user is provided with a list of command 
switches and defaults used by PRESRV. /HE is a stand-alone switch and 
must therefore be typed as a separate command. 


CAUTION 


When using RPO04 disk pack or TU16 
9-track magnetic tape, it is advisable 
to bootstrap PRESRV from its original 
medium, to configure it if necesssary 
(using the /CSR switch and other 
switches as described in Section 4.4) 
and to write a DECtape, magtape, 
cassette or floppy disk by preserving 
some volume with a command. For 
example: 


PRE>DTO:ZORG=DKO:/IM 


A filelabel must be specified if the 
output is in logical tape mode. 
Subsequent booting of the logical tape 
will bring up a user-tailored version of 
PRESRV. The data on the logical tape is 
of no consequence. 
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If PRESRV halts at location 522 while in the course of trying to 
perform a function, the system has crashed. The probable cause of the 
crash is the use of improper values for the Control Status Register 
(/CSR) or vector address (/VEC) for one of the specified devices in 
the command string. Rebootstrap PRESRV, set the correct CSR_ and 
vector addresses for the devices in question and retype the command. 
See Section 4.4 for a list of devices and their corresponding CSR _ and 
vector addresses. 


After the identification message is displayed PRESRV is ready to 
accept a command and responds with PRE> on the console terminal. 
PRESRV accepts command strings containing up to 80 characters. PRESRV 
commands are of the form: 


outspec/switch../switch=inspec/switch../switch 


Outspec and inspec represent the output and input device respectively. 
Each input or output device has the following format: 


dev:filelabel 
where 


dev: is the physical device on which the volume containing 
the desired file is mounted, for example, DKO: The 
name of the device consists of two ASCII characters 
followed by an optional unit number and a colon. If 
no unit number is specified, PRESRV assumes a default 
by assigning a unit number of 0 to the device. 


filelabel is the label given to the logical tape file to be 
copied or created. PRESRV accepts filelabels of 1 to 
12 characters. A filelabel must be specified if the 
output is in logical tape mode. 
If the specified device is not ready or up to speed, PRESRV prints: 


DEVICE NOT READY 


If the device or unit combination specified in the command string is 
not supported by the current PRESRV program or is not a valid device 
for PRESRV operations, PRESRV prints the following message: 


NO SUCH FILE 


Retype the command using the proper filelabel. Output and input 
specifiers can be modified by one of three types of switches: 


/switch a two character ASCII name identifying the switch 
option, or 


or the switch option followed by a colon or equal 


/switch:nn a two-or three-character ASCII name identifying 
/switch=nn sign and an alphanumeric value. 


These switches are listed for reference in Table 2. 
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If two conflicting switches are specified in the command string (for 
example, /TP/FI), PRESRV prints the following error message: 


CONFLICTING SWITCHES 


Retype the command string with the correct switch(es) specified. 


Table 2 
PRESRV Option Switch Descriptions 


ABORT ON I/O ERROR Causes termination of the 
current PRESRV operation 
upon an unrecoverable I/0 
error. /ER applies to 
either input or output file 
specifiers but not to both. 


BLOCKING SWITCH Blocking can be imposed on 
copy operations either on 
logical tapes or 
block-structured devices. 
nn followed by a decimal 
point is the number of 
256(10)-word blocks in each 
record. Without the 
decimal point, nn is 
interpreted as an octal 
number. The /BL switch can 
apply to either input or 
output file specifiers. 
However, when the input 
volume is a logical tape, 
the input blocking factor 
is overridden by the 
blocking factor of the 
label. 


LOGICAL TAPE MODE Overrides an inappropriate 
PRESRV default. On output 
/TP can apply to any device 
and the result of the copy 
operation is a logical 
tape. On input the volume 
to which /TP is attached 
must be in logical tape 
mode. 


REWIND AT COMPLETION | /RW 


Rewinds any physical tape 
that has completed the 
specified copy operation. 
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Table 2 (Cont.) 
PRESRV Option Switch Descriptions 


Option Switch Syntax Description 


TIME AND DATE 


/TIM=mm/dd/yy hh:mm | Sets the time and date of 


the copy operation. 


mm is the month (1-12) 


dd is 


the day (1-31) 


yy is the year (0-99) 


hh is 


the hour (0-23) 
mm is the minute (0-59) 


The /TIM switch is a 
stand-alone switch and must 
therefore be typed ina 
separate command. 


BOOTSTRAP dev :/BO Causes PRESRV to bootstrap 
the system on the specified 
device, read the first 
block (bootstrap block) and 
pass control to it. 


CONTROL STATUS dev:/CSR=nnnnnn Sets the address of the 

REGISTER Control Status Register to 
nnnnnn, which is the octal 
address of the CSR used by 
the specified device. 


DEVICE SPECIFIC MTn:/20 Sets the density of TU1O 
SWITCHES 7-track drive n to 200 bpi. 


MTn:/55 Sets the density of TU10 


7~track drive n to 556 bpi. 


MTn:/80 Sets the density of TU10 
7-track drive n to 800 bpi. 
The /20,/55 and /80 
switches apply only to a 
7-channel TU10 drive being 
copied in image mode. 

These switches may be 
applied to either the input 
or output file specifiers. 


Phase-Encoded 
Tape 


Indicates magnetic tape 
volumes, to be written or 
read on a TU16 drive, are 
to be treated in 
phase-encoded mode (1600 
bpi). The /PE switch may 
appear on either t'a input 
Or output side of the 
command string. 
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Table 2 (Cont.) 
PRESRV Option Switch Descriptions 


Format Disk Enables PRESRV to write the 
necessary timing and sector 
identification information 
on RKO5, RPO2, RPQ3 and 
RPO4 disks to prepare them 
for storing data. The /FO 
switch may only be 
specified on the output 
side of the command string 
and may be used as a 
stand-alone switch or in 
conjunction with a copy 
operation. 


/VEC=nnn Sets the interrupt vector 
for a device. nnn is the 


new octal vector address.. 


TMO2 Formatter 


MMn:/TM02=x Sets x as the RH unit 
number of the TM02 
formatter for the TU16 tape 


drive n. 


/UNIT=n Sets to n the physical unit 
number for a device. The 
/UNIT switch is used to 
refer to units 2 through 7 
in place of either unit 0 
or 1 of a specified device. 


FILES-11 MODE Overrides an image mode 
copy operation of devices 
not written in FILES-11 
mode. The /FI switch may 
apply to either input or 


output file specifiers. 


HELP COMMAND Prints a summary of PRESRV 
services. This isa 
stand-alone switch and, 
therefore, must be typed as 


a separate command. 


IMAGE MODE 


Overrides the FILES-1l1 
default in copying 
disk-structured volumes. 


LISTING 


Lists a directory (a list 
of all filelabels) of a 
logical tape. The /LI 
switch is a stand-alone 
switch and must, therefore 
be typed in a separate 
command. 
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Table 2 (Cont.) 
PRESRV Option Switch Descriptions 


Description 


VERIFY SWITCH Causes a second pass over 
the input and output media 
so that every block written 
on the output device is 
read back and compared with 
the corresponding block on 
the input device. If the 
comparison fails, a 
verification failure is 
declared. The /VE switch 
may appear on either side 
of the command string. 


3.2 Primary Command Switches 


3.2.1 Image Mode (/IM) Switch - When copying disk-structured volumes 
to logical tape the Image Mode (/IM) switch overrides the FILES-11l 
default. By using the /IM switch an operator can copy any format disk 
to tape. For example, the following command string copies information 
on DKO: to MTO: 


PRE>MT0O:STAR=DK0:/IM 
A filelabel must be specified when the output is in logical tape mode. 
PRESRV writes 512-character records on magnetic tape unit 0. The /IM 
switch is used to override the FILES-ll default attached to the RKQ5 
cartridge disk. Tf the input and the output devices are identical, 
the copy is made in image mode, and the /IM switch is not required. 
Tf the /IM switch is specified when copying information from a 
magnetic tape to another magnetic tape, PRESRV responds with the 
following error message: 

TRANSFER SPECIFICATION MODE ERROR 
Retype the command without specifying a switch. 


When a tape drive is the output device, PRESRV prints the following 
message: 


MOUNT OUTPUT VOLUME 1. AND TYPE CR> 
Mount the first volume and type the RETURN key. 


If the output volume specified needs a write-ring, PRESRV prints’ the 
following message: 


OUTPUT VOLUME WRITE-LOCKED. TYPE CR WHEN READY > 


Insert the write-ring and type the RETURN key. 
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3.2.2 Phase-Encoded Tape PE) Switch - Magnetic tape volumes to be 
written or read on a TUl16 drive are treated in phase-encoded mode 
(1600 bpi) by supplying the phase-encoded tape (/PE) switch. The /PE 
switch must be specified with the filelabel of a TU16 device. For 
example, 


PRE>MMO:filelabel/PE=DB0:/IM 


PRESRV writes the bootstrap block, label block and PRESRV image at 800 
bpi but writes the data from the RPO4 disk at 1600 bpi. A block size 
of 1 is used. The /IM switch is used to override the FILES-1l default 
attached to RPO4 unit 0. 


3.2.3 Logical Tape Mode (/TP) Switch - The logical tape mode (/TP) 


switch is used to override an inappropriate PRESRV default. On output 
/TP can apply to any device and the result of the copy operation is a 
logical tape. 
On input the volume to which /TP is attached must be in logical tape 
mode. For example, the following command string restores an RKO3 or 
RKO5 cartridge preserved on DECtape. 

PRE>DKO:=DT0O:ART/TP 


The /TP switch is optional in the above example because the filelabel 
attached to the input device indicates logical tape. 


3.2.4 Verification (/VE) Switch - The verification (/VE) switch 
causes PRESRV to verify the copy operation. For example, PRESRV 
compares the output device to the input device to make sure there are 
no differences. 


When the verification operation begins, PRESRV responds with the 
following message: 


**BEGIN VERIFICATION** 


This will cause a second pass over the input and output media so that 
every block written is read back and compared with the corresponding 
block on the input device. When verification is requested, twice the 
number of output buffers is needed. The /VE switch may appear on 
either side of the command string. For example: 


PRE>DK1:/VE=DKO: 
PRE>DK1:=DKO0:/VE 


If the verification is successful, PRESRV prints 
PRE> 
and will accept another command. 


If the comparison fails, PRESRV prints the following error message: 


VERIFICATION ERROR nnnnnnn 


12 


PDP-11 PRESRV USER'S GUIDE 


The number printed is the octal logical block number on the output 
device where the error was detected. Retry, continue or abort the 
operation. 

if the volume to be verified is faulty, PRESRV responds whenever a 
verification error occurs, with the following error message: 


VOLUME FAULTY ~ "R" TO RETRY, "C" TO CONTINUE> 


Type R to retry or C to continue the operation. 


NOTE 


If the user types the ALTMODE key when 
PRESRV is ready to accept input, the 
current operation is aborted. 


3.2.5 Rewind at Completion (/RW) Switch - The Rewind at Completion 


(/RW) switch enables PRESRV to rewind any physical tape after the copy 
operation has been completed. The /RW switch applies to either input 
Or output file specifiers. For example: 


PRE>MT1: JOAN/RW=DP0: /IM 


rewinds the tape after information on RP03 unit 0 has been copied to 
Magnetic tape unit l. 


3.2.6 FILES-1]1 Mode (/FI) Switch - The FILES-1l1 mode (/FI) switch 


applies only to FILES-11 devices (Disk and DECtape). The /FI switch 
overrides a default that would result in a PRESRV operation not 
intended by the user. For example, when units are identical and no 
formatting switches are specified, the copy operation is in image 
mode. A FILES-11 copy operation is made by using the /FI switch. The 
/FI switch may apply to either input or output file specifiers. 


NOTE 


If an image copy operation (DK0:=DK1:) 
fails and the input volume is FILES-1l, 
use a /FI transfer to copy only blocks 
in use. The blocks that are unreadable 
may be free blocks that do not contain 
data. /FI copy operations take more 
time and should be used only if I/0 
errors occur in an image mode copy. The 
following is an example of an /FI copy 
operation. 


PRE>DKO:/FI=DK1:/FI 


13 


PDP-11 PRESRV USER'S GUIDE 


3.2.7 Abort on I/O Error ER) Switch - If the Abort on I/O Error 
(/ER) switch is attached to a file specifier, an unrecoverable I/O 
error causes the termination of the current PRESRV operation. After 
issuing an error message, PRESRV prints 


PRE> 
and is ready to accept another command. 


The /ER switch applies to either input or output file specifiers. For 
example: 


PRE>DK1:/ER=DKO: 


If a write error occurs and the /ER switch has not been specified, 
PRESRV responds with the following message: 


VOLUME FAULTY - "R" TO RETRY, "C" TO CONTINUE> 


Type C to continue or R to retry the operation. 


NOTE 


If the user types the ALTMODE key when 
PRESRV is ready to accept input, the 
current operation is aborted. 


3.3 Command String Examples 


3.3.1 Disk to Magnetic Tape (TU10) ~- The following is an example of 


copying information from a disk to a 7-channel magnetic tape: 
PRE>MTO:filelabel/BL: 20./VE=DK0:/IM 


A filelabel must be specified when the output is in logical tape mode. 
The /IM switch overrides the FILES-11 default attached to RKO5 unit 0 
and copies information onto magnetic tape unit 0 in logical tape mode 
at 800 bpi. 


The /VE switch causes a second pass over the input and output media 
after the data on the input device is copied onto the output device. 
Every block written is read back from magnetic tape unit 0Q and 
compared with the corresponding block on the input device. 


Because the /BL:nn switch is specified, PRESRV writes 20 blocks per 
record on the output tape. This is the most efficient processing 
method. Normally, only one block per record is’ used. Since a 
512-character record occupies one-half an inch on the tape and the 
interrecord gap is three-fourths of an inch, a blocking factor of one 
is wasteful. Verification also uses 20 blocks. Thus all available 
memory is used for the copy operation: two 20-block buffers for the 
Magnetic tape copy operation and verification and a 12-block buffer 
for RKO5 disk. (See Section 4.2 for more information on computing 
required blocks for buffering.) 


14 


PDP-11 PRESRV USER'S GUIDE 


PRESRV requests the user to mount the file output volume by printing 
the following message: 


MOUNT OUTPUT VOLUME 1 AND TYPE CR> 


After the RETURN key is typed, PRESRV creates the file specified by 
the filelabel. 


Upon copying the data, PRESRV rewinds the tape and performs’ the 
verification as signalled by the **BEGIN VERIFICATION** message. 
PRESRV continues to request the user to mount subsequent volumes until 
all data on the RKO5 has been copied. The end of the copy operation 
is signalled by the PRESRV Prompting message (PRE>). 


If the input device is RP04, the INSUFFICIENT BUFFER SPACE error is 
generated because the RPO4 default is 22 blocks for buffering. Simply 
override the default by using the /BL switch on input as follows: 


PRE>MT0:ZEUS/BL: 20./VE=DB0:/BL:11./IM 


A blocking factor of 11 is a submultiple of the number of blocks on 
the volume (167200) and overrides the default of 22. AS a result, 
sufficient buffer space is available: two 20-block buffers for the 
Magnetic tape copy operation and verification and an 1ll-block buffer 
for the RPO4 disk. 


3.3.2 Magnetic Tape (TU10) To Disk ~ To restore a disk from a logical 


tape the following format is used: 
PRE>DPO: /VE=MT0: TERRY 


PRESRV requests the user to mount the first input volume by printing 
the following message: 


MOUNT INPUT VOLUME 1 AND TYPE CR> 


After the RETURN key is typed, PRESRV searches for the file specified 
by filelabel. tf the file specified in the command string was not 
found on a logical tape, PRESRV prints the following error message: 


NO SUCH FILE 
Retype the command using a proper filelabel. 


If no filelabel is specified, PRESRV assumes. the tape is properly 
positioned (at the load point for the first file or between two EOF 
tape marks for subsequent files) and takes the next file on the tape 
as input. The blocking factor for magnetic tape is taken from the 
filelabel. The blocking factor on output is the default (10) for an 
RPO2 or RPQ3 disk. If the data is continued on a subsequent volume, 
PRESRV prints the following message: 


MOUNT INPUT VOLUME 2 AND TYPE CR> 


15 


PDP~11 PRESRV USER'S GUIDE 


PRESRV checks the filelabel and volume number on magnetic tape unit 0 
before continuing. If the volume number is incorrect, the following 
message is printed: 


INPUT VOLUME 2 OUT OF SEQUENCE 


Mount the proper volume and proceed. PRESRV continues in this fashion 
until the end of volume is reached. After all reels have been copied, 
PRESRV makes a second pass over the data for verification. The user 
must mount all reels beginning with the first volume and continuing in 
sequence until the last volume is verified. PRESRV uses 10 extra 
blocks of buffer space for the verification. The end of verification 
is signalled by the PRESRV prompting message (PRE>). 


3.3.3 Disk to Magnetic Tape (TU16) - To copy information from a disk 
to a TU16 magnetic tape the following command string is used: 


PRE>MMO: RICHARD/PE/VE/BL: 20.=DB0:/IM/BL:11 


A filelabel must be specified when the output is in logical tape mode. 
The /IM switch is used to override the FILES~1l default in copying 
block-structured volumes to tape. The /PE switch enables PRESRV_ to 
write data on the TU16 drive at 1600 bpi. PRESRV always writes 
filelabels and bootstrap blocks, however, at 800 bpi. The /BL:20 
switch causes PRESRV to use the most efficient blocking factor as 
described in Section 3.3.1. The /BL:11 switch overrides the 22-block 
default for RPO4 and allows sufficient buffer space (51 blocks) for 
the copy operation and verification to occur. The /VE switch causes a 
second pass over the input and output media so that every block 
written is read back from magnetic tape unit 0 and compared with the 
corresponding block on the input device. Action messages are printed 
as described in Section 3.3.1. 


3.3.4 Magnetic Tape (TUI6 ) To Disk ~ To restore a disk from a TU16 
Magnetic tape written at 1600 bpi the following format is used. 


PRE>DBO:/BL:11./VE=MM0: RICHARD/PE 


The /PE switch enables the TU16 drive to read the data at 1600 bpi 
(the filelabel is read at 800 bpi). PRESRV reads data from magnetic 
tape unit 0 with the blocking factor it finds in the label record. 
(This blocking factor is 20 if the tape was written following the 
procedures described in the disk to Magnetic tape (TU16) copy 
operation shown above. The /BL:1l. switch overrides the default 
blocking factor of 22 used for RP04 disks and allows sufficient buffer 
space for verification of a magnetic tape written with a blocking 
factor of 20. (Two ll-block buffers are allocated for copying and 
verifying the RPO04 records and one 20-block buffer for the magnetic 
tape records.) Refer to Section 4.2 for a discussion on computing 
required blocks for buffering. 


The /VE switch causes a second pass over the input and output media 
after all reels have been copied. (The action messages are described 
in Section 3.3.2.) Every block written is read back from RP04 unit 0 
and compared with the corresponding block on the input device. 


16 


PDP-11 PRESRV USER'S GUIDE 


3.3.5 Magnetic Tape TU1O to Magnetic Tape TU10) - To copy 
information from a magnetic tape to another magnetic tape the 
following format is used. 


PRE>MT1:=MTO: 


When copying two identical devices, image mode is automatically 
assumed and no switch is needed. If an /IM switch is specified in a 
tape to tape copy operation, PRESRV prints the following error 
message: 


TRANSFER SPECIFICATION MODE ERROR 
Retype the command string without specifying a switch. 


The image copy mode uses the default memory buffer space to create 
blocks on magnetic tape unit 1. (See Section 4.3 for default blocking 
factors.) If any input record is too large, the copy operation is 
aborted. PRESRV assumes the tape is correctly positioned at the load 
point or positioned after an EOF tape mark when no filelabel is 
specified on the input side of the command. 


3.3.6 Magnetic Tape (TU16) to Magnetic Tape (TU16) - To copy 
information from a magnetic tape (TU16) to another magnetic tape 
(TU16) the following format is used: 

PRE>MM1:/PE/TP=MM0:/TP/PE 


The phase-encoded tape (/PE) switch is used when reading or writing 
information on a TUl16 drive written at 1600 bpi. The /TP switch 
overrides the image mode default when copying two identical devices. 


3.3.7 Disk to Disk ~- To copy information from a disk to another disk 
the following format is used: 


PRE>DP1:=DPQ: 
When copying information from a device onto a similar device, image 
mode is automaticlly assumed and a switch is not required. If more 


memory is available, the block (/BL:nn) switch can be used to speed 
the copy operation. 


3.3.8 DECtape to DECtape - To copy information from a DECtape_ to 
another DECtape the following format is used: 


PRE>DT1:=DTO: 


Image mode is automatically assumed when copying information on _ two 
identical devices. The /IM switch is not required. 


3.3.9 Disk to DECtape - When copying information from a disk to 
DECtape, the following format is used: 


PRE>DTO: IGOR/VE=DK0:/IM 
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A filelabel must be specified on the output side of the command for 
disk to DECtape copy operations or when the output is in logical tape 
mode. The /IM switch is used to override the FILES-11 default 
attached to RKO5 unit 0 and copies the information onto DECtape unit 0 
in logical tape mode. Ten DECtapes are required for copying 
information from one RKO5 disk cartridge. The /VE switch causes a 
second pass over the input and output media after information is 
copied to the output reel so that every block written is read back 
from DECtape unit 0 and compared with the corresponding block on_ the 
input device. 


PRESRV requests the user to mount the first output volume by printing 
the following message: 


MOUNT OUTPUT VOLUME 1 AND TYPE CR> 


After the RETURN key is typed, PRESRV creates the file named IGOR on 
DECtape unit 0. 


Upon copying the data, PRESRV rewinds the tape and performs’ the 
verification as signalled by the **BEGIN VERIFICATION** message. 
PRESRV continues to request the user to mount subsequent volumes until 
all data on the RKO5 device has been copied. The end of the copy 
Operation is signalled by the PRESRV prompting message (PRE>). 


3.3.10 DECtape To Disk - To restore information to a disk from 
DECtape the following format is used: 


PRE>DKO:/VE=DT0: IGOR/TP 


PRESRV requests the user to mount the first input volume by printing 
the following message: 


MOUNT INPUT VOLUME 1 AND TYPE CR> 


After the RETURN key is typed, PRESRV searches for the file specified 
by the filelabel on the input side of the command. If the file 
specified in the command string was not found on a logical tape, 
PRESRV prints the following error message: 


NO SUCH FILE 
Retype the command using a proper filelabel. 
A filelabel is used in the above copy operation because a filelabel 
was specified in the initial copy operation. The /TP switch is 


optional in the above example because the filelabel attached to DT0: 
indicates logical tape. 
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4.0 AUXILIARY OPERATIONS 


4.1 Formatting the Disk - (/FO) Switch 


PRESRV writes the necessary timing and sector identification on RKO3, 
RKO5, RPO2, RPO3 or RPO4 disks to prepare them for storing data. This 
operation is called formatting the volume and is specified by the /FO 
switch. Formatting may be specified as a separate operation or in 
conjunction with a copy operation. If a copy operation has been 
specified, the disk is formatted before information is copied to it. 


If the device specified for formatting is not one of these devices, 
PRESRV prints the following message: 


DEVICE NOT FORMATTABLE 
Specify the correct device mnemonic. 


The /FO switch may only be specified on the output side of the command 
String. For example: 


PRE>DPO:/FO 
or 
PRE>DPO: /FO/VE=MT0:DISK 


When formatting begins PRESRV prints the following message on _ the 
user's terminal. 


** BEGIN FORMATTING** 
If an RPO2, RPO3 disk is being formatted, however, the format switch 
on the RP11-C controller must be enabled. Perform the following 
steps: 


1. Remove the third panel below the bank of indicator lights on 
the RP11-C controller. 


2. Set the FORMAT ENABLE/NORMAL switch to the FORMAT ENABLE 
position. (It is the switch farthest to the left.) 


3. When formatting is completed, set the FORMAT ENABLE/NORMAL 
Switch to the NORMAL position. 


PRESRV prompts the user to enable and disable formatting at the proper 
times by printing the following messages: 


ENABLE FORMATTING WITH SWITCH ON CONTROLLER. TYPE CR WHEN READY> 
or 

DISABLE FORMATTING WITH SWITCH ON CONTROLLER. TYPE CR WHEN READY> 
When the switch is properly set, the user should press the RETURN’ key 
to continue. When formatting has been completed, PRESRV prints the 


following message: 


**END FORMATT ING** 
PRE> 


The PRE> message indicates that another command can be typed. 
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NOTE 


If the user types the ALTMODE key when 
PRESRV is ready to accept input, the 
current operation is aborted. 


4.2 Computing Reguired Blocks for Buffering 


In the display of the number of blocks available for buffering nn. is 
the number of 256(10)-word blocks available for data copying and 
verifying operations. The user must use nn. to determine if a given 
PRESRV media copy has sufficient buffering space. The space required 
depends on blocking factors and use of the verification (/VE) switch. 
See Section 4.3 for information on default blocking factors for 
devices supported by PRESRV. 


To determine the blocks needed for PRESRV copy operations, blocks 
reguired for input, output and verification must be established. 


Example 1: 
PRE>MTO:MARY=DK0:/IM 
creates a logical tape labeled MARY on magnetic tape unit 0. 


Blocking requirements are: 


Input 12. (DK default block size) 
Output 1. (MT default block size) 
Verification 0. (no verification specified) 
Total 13. 


Example 2: 
PRE>DKO:=MT0:HELEN 


copies file HELEN from magnetic tape unit 0 to disk cartridge unit 0. 


Input n. (Record size specified in file HELEN's label) 

Output 12. (DK default block size) 

Verification 0. (no verification specified) 

Total x. (Output block size plus record size of file 
HELEN) 
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EXAMPLE 3: 
PRE>MTO:LORRY/BL: 20./VE=DK0:/IM 
creates a logical tape labeled LORRY on magnetic tape unit 0. The /VE 


switch causes each block written to MTO: to be read and compared to 
the corresponding block on DKO: 


Input 12. (DK default block size) 
Output 20. (MT block size specified by the /BL:20. 
switch) 


Verification 20. (Reread 20 blocks from MTO:) 

Total 52. 
Example 4: 

PRE>DKO: /VE=MT0:SHARON/TP 
copies file SHARON from magnetic tape unit 0 to disk cartridge unit 0. 
Each record written to DKO0: is read and compared to the corresponding 
block on the input device. The /TP switch is optional in the above 
example because the filelabel attached to MT0: indicates logical 
tape. 


Input n. (Record size of file SHARON printed in 
Output of /LI switch) 


Output 12. (DK default block size) 
Verification 12. (Reread block from DKO:) 


Total x. (Output block size, verification and record 
size of file SHARON) 


Example 5: 

PRE>MMO:=MM1: 
copies the data on TU16 unit 1 to unit 0 at 800 bpi. The image copy 
mode uses all available memory buffer space to create blocks on 
massbus magnetic tape unit 0. If any input record is too large, the 
operation is aborted. 
Example 6: 

PRE>MMO: /VE=MM1: 
is the same as example 4 except that verification is requested. 
One-third of available memory buffer space is used to form blocks to 


be written to MMO:. If any input record is too large, the operation 
is aborted. 
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4.3 Default Blocking Factors —- BL:nn) Switch 


Blocking can be imposed on copy operations either on logical tape or 
block-structured devices by specifying the blocking (/BL) switch. A 
block is a group of 256-word units that represents the amount of data 
that is copied by a single read or write issued by PRESRV. If the 
number of blocks specified with the /BL switch is too large for the 
available buffer space or is 0, PRESRV prints the following message: 


ILLEGAL BLOCK COUNT 
Retry the operation using a valid block count. 


When PRESRV is loaded, the number of blocks available for buffering is 
printed. PRESRV runs unmapped on the PDP-1l and, therefore, uses a 
maximum of 28K words, 15K words of which are occupied by the executive 
and PRESRV itself. Thus, the current version of PRESRV has available 
13K words, or 52 blocks, for buffering. 


Each device has a default blocking factor that is used by PRESRV when 
no blocking switch is specified, and when buffer space is available to 


perform the default blocking. See Table 3 for default blocking 
factors. 


Table 3 
Default Blocking Factors 


DEVICE | FORMAT CLASS* | DEFAULT BLOCK SIZE** | MAXIMUM BLOCK CAPACITY 
CT LT l. 


variable 
22. 


167200 (RPO4) 


1024 per platter 


4800 (RKO5) 


80000 (RPO3) 


40000(RPO2), 


1024 (RS03), 2048 (RSO04) 


572 (TC11/TU56) 


494 (RX11/RX01) 


variable 


variable 


*LT denotes Logical Tape. 
BS denotes Block-Structured. 


**The decimal point indicates decimal values. Without the decimal 
point, the values are interpreted as octal numbers. 
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Default blocking factors are overridden as follows: 


l. For block~-structured devices the /BL switch can be used on 
either inpu Or output file specifiers to establish a 


2. For logical tape output, a /BL switch can establish the 
blocking factor. 


3. For logical tape input,the blocking factor is always. taken 
from the filelabel; the /BL switch is ignored. 


4. If a tape is being copied in image mode, PRESRV uses a 
blocking factor that exhausts all available buffering space. 


The /BL switch is of the form: 
/BL:nn 
where 


nn is the number of 256(10)-word blocks in each record. These 
blocks may be specified in octal or decimal (with trailing 
decimal point). 


The /BL switch can apply to either input or output file specifiers. 
For example: 


PRE>DK1:/BL:48.=DKO0: 


By specifying a blocking factor of 48. the cartridge disk default 
block size of 12 is overridden. 


When specifying block sizes, a trailing decimal point must be used 
following a base 10 number. If a trailing decimal point is not used 
and an illegal octal digit (8 or 9) is present, PRESRV prints’ the 
following error message: 


SYNTAX ERROR 


Retype the command with a decimal point after the base 10 block size. 


NOTE 


1. For image copies, the blocking 
factor specified with a disk or 
DECtape must be a submultiple of the 
number of blocks on the volume (for 
example, 4800 for DK). 


2. If buffer space permits, use a large 
blocking factor for DECtape to speed 
the copy operation. 


4.4 Hardware Specific Switches 


Hardware specific switches are acted upon immediately by PRESRV and no 
other commands are accepted until PRESRV completes the current 
command. 
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4.4.1 Control Status Register CSR) Switch - To set the control 
status register for a device, use the /CSR switch. The following 
format is used for setting the CSR: 

dev:/CSR=nnnnnn 
where 

dev: is the device whose CSR is to be changed. 

nnnnonn is the octal address of the CSR used by the device. 
For example: 

PRE>DBO: /CSR=176300 
See Table 4 for a list of devices and their corresponding CSR _ and 


vector addresses. 


Table 4 
Devices and Corresponding CSR and Vector Addresses 


DEVICE VECTOR* 


177500 
176700 
177460 
177404 
176714 
172040 
177342 
171700 
172440 


MT 172522 


*The asterisk (*) indicates that this is not a normal vector. 


4.4.2 Vector Address (/VEC) Switch - To set the vector address for a 
device the following format is used: 


dev: /VEC=nnn 
where 
dev: is the device-unit whose vector address is to be changed. 


nnn is the new octal vector address. 
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For example: 
PRE>MMO:/VEC=224 


4 for a list of devices and their corresponding vector 


Two units (physical unit number 0 and 1) were generated for each 
device type. Both units of each device type are defined as being on 
the same controller. Thus, if the CSR or vector address is changed 
for one unit, it is automatically changed for the other unit. 


All the CSR assignments generated into PRESRV are the normal CSR 
assignments for those devices; however, some of the devices have 
vector addresses that overlap the vectors of other devices. By using 
the /VEC=nnn switch, the normal vectors for those devices can be 
established. 


DEVICE NORMAL VECTOR 


DB 254 
DS 204 
MM 224 


If the generated CSR or vector address does not correspond to. the 
actual hardware configuration in use, the /CSR and /VEC commands can 
be used to correct PRESRV generated values. 


CAUTION 


When using an RPO4 disk pack or TU16 
9~track magnetic tape, it is advisable 
to bootstrap PRESRV from its original 
medium, to configure it if necessary 
(using the /CSR switch and other 
Switches as described in Section 4.4) 
and to write a DECtape, magnetic tape, 
cassette or floppy disk by preserving 
some volume with a command. For 
example: 


PRE>DTO: ZEUS=DKO:/IM 


A filelabel must be specified on the 
output side of the command string when 
dissimilar devices are specified. 
Subsequent booting of the logical tape 
brings up a user-tailored version of 
PRESRV. The data on the logical tape is 
of no consequence. 


4.4.3 TMO2 (/TM02) Switch - The /TMO2 switch sets the unit number of 
the TM02 tape formatter on the RH controller. The format is: 


dev: /TM02=n 
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where 
dev: is a device whose TMO02 formatter position on the RH 
controller is to be changed. 
n is the unit number desired. 


For example: 
PRE>MMO: /TM02=2 


By using the /UNIT and the /TM02 switches it is possible to set the 
mapping of device mnemonic to the actual physical devices. 


4.4.4 Unit (/UNIT) Switch - The /UNIT switch sets the desired 
physical unit number for a device mnemonic, allowing PRESRV to support 
device configurations with more than one drive of the same device 
type. For example: 


PRE>DKO: /UNIT=2 


sets DKO: to physical unit 2 and every reference to the name DKO: 
actually refers to physical unit 2 on the RH11 controller. This is 
the only method of using units other than 0 and l. Another use for 
the /UNIT switch is for mixed Massbus peripherals. It is possible to 
attach RPO4, RS03/04 drives and TMO2 tape formatters to the same 
RH11/RH70 controller; however, operating system software may not 
support such a configuration. The /UNIT switch selects the unit 
number of RP04, RS03 and RSO4 disk drives on the RH controller or the 
drive number of the TU16 tape drives on the TMO2. 


The /CSR, /VEC, /UNIT and /TMO02 switches may all be specified on the 
same command line. 


4.5 Auxiliary Stand-Alone Switches 


4.5.1 Listing (/LI) Switch - The listing (/LI) switch lists from the 
device specified all tape filelabels, the device from which the data 
originated, the volume number, block number, record size, and the date 
and time of the copy operation. The /LI switch is of the following 
format: 


dev:/LI 
The specified device must be formatted as a logical tape. Whether or 
not the device was created with the /PE switch specified, the tape 
labels are always written in 800 bpi mode on 9-track drives. Thus the 
/PE switch is not needed to list the files on a tape created at 1600 
bpi. The /LI switch is a stand-alone switch and must, therefore, be 
typed as a separate command. For example, after typing 

PRE>DMT1:/LI 
PRESRV prints a message similar to the following: 


LAB:A FRM:DKO VOL 1. BLK:1. RECSIZ:512. 29-APR-74 00:01:34 
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where 
LAB:A is the name given to a file written to a _ logical 
tape. 
FRM: DKO is the source device. 
VOL l. is the volume number of the input device. 
BLK:1. is the number of blocks used in the copy 


operation. 


RECSIZ: 512. is the block size. 512 is the number of 
characters per block. 


29-APR-74 is the date of the copy operation. The default is 
the creation date of the input device. 


00:01:34 is the time of the copy operation. The default is 
the time the input device was created. 


4.5.2 Time (/TIM) Switch - The time (/TIM) switch sets the time and 
date of the copy operation and is of the following format: 


/TIM=mm/dd/yy hh:mm(:ss) 
where 


mm/ is the month (1-12) 
dd/ is the day (1-31) 
yy is the year (0-99) 


hh: is the hour (0-23) 
mm: is the minute (0-59) 
ss is the second (0-59) (optional) 


For example: 
/TIM=8/29/75 15:15 


sets the date of the copy operation to August 29, 1975 and the time to 
3:15. 


All values are decimal without a trailing decimal point. The /TIM 
switch is a stand-alone switch and must, therefore, be specified as a 
separate command. 


The value set by the /TIM switch is used as the base from which the 
date and time of day is calculated. The calculated values are written 
in the label block of logical tapes. If the /TIM switch is not 
specified, PRESRV uses the creation date and time of the input device 
as the base. 
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4.6 Device Specific Switches 


Device Specific Switches (/20, /55 and /80) define the density of the 
tape and apply only to 7-channel TU1LO magnetic tapes operating in 
image copy mode. When 7-channel tape is being used, the copy 
operation must be accomplished in image mode. If no tape density is 
defined, the default is 800 bpi. For example: 


PRE>MTO:/VE=MT1: 
automatically sets the density of the tape to 800 bpi. 
PRE>MTO:/VE=MT1:/55 
sets the density of the tape to 556 bpi. 
PRE>MTO:/VE=MT1:/20 


sets the density of the tape to 200 bpi. 


NOTE 


Logical tapes written on 7~-channel 
drives are always in core-dump mode (two 
4-bit frames per byte). 


5.0 RESTORING THE MONITOR - (/BO) SWITCH 


The PRESRV program is a stand-alone program and thus, runs 
independently of any other system. When PRESRV is completed, the user 
may bootstrap a monitor from unit 0 of a specified device by using the 
bootstrap (/BO) switch. For example: 


PRE>DKO:/BO 
system monitor identification 


The above command string causes a monitor to be read from unit 0 of 
any device and loaded into core. The /BO switch is a stand-alone 
switch and must, therefore, be typed as a separate command. 


6.0 SAMPLE RUN 


The terminal dialogue from a sample run of PRESRV is shown below. A 
RSTS/E system disk (RK) was mounted on drive 0 and bootstrapped to 
obtain the first two lines of dialogue. A TU10 9Q9-channel magtape 
containing PRESRV was then mounted, write protected, on drive 0 and 
bootstrapped. The first command to PRESRV set the date and time. The 
RSTS/E disk was then write protected, and a command was issued to 
PRESRV to perform an image mode copy of DKO: to file TSTFIL on MTl:. 
Verification was requested, and the blocking factor was arbitrarily 
set at the octal number 24 which is eguivalent to a decimal number of 
20. 
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Input 12. (DK default block size) 


Output 20. (MT block size specified by the /BL:24 
(octal) switch) 


Verification 20. (Reread block from MTO:) 
Total 52. 


A zeroed magtape was then mounted, write enabled, on drive 1, and the 
RETURN key was typed to begin the copy. 


Upon completion of the copy, a directory of MT]: was requested to 
verify that the file TSTFIL had been created. 


The RSTS/E disk was then removed from drive 0, and a scratch disk was 
mounted, write enabled, on drive 0. The next command to PRESRV 
requested that the contents of MTl: (TSTFIL) be copied to the scratch 
disk on drive 0. Formatting and verification were requested. When 
PRESRV completed the copy, a command to bootstrap disk 0 was given, 
and the final two lines of dialogue were obtained. Figure 3 below 
shows the terminal dialogue. 
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—<——_——— Boot DK@: 


RSTS VO6xX-00 SYSTEM ne 


OPTIONS 


RSX-21S VOL BLie 
VOLUME FRESERVATION FROGRAM: ~ YOR. 1 
FOR HELP TYPE /HE 
vee BLOCKS AVATLABLE FOR BUFFERING 


+ — Boot MTP: 


PRES/TIM#O9/30/75 21100100 <«————__—_——_————_ Set date and time 
PREOMTL$TSTFIL/BL?24/VE<DK0t/IM <<. Copy DK@: to MT1:TSTFIL 
MOUNT OUTPUT VOLUME 2. ANT TYPE Cho 

**k BEGIN VERIFICATION xx 

PRESMTL2/L 1 <————___________- Obtain directory of MT1: 
LAR TSTF TL FRMS0KO VOL 1. BLING 20. RECSIZ¢10240. 30-SEP-75 21200200 
PRESDIKNOS/FO/VE=MT1STSTF IL «—————_-. Copy MT1:TSTFIL to new DK: 
*K REGIN FORMATTING *x 

**K END FORMATTING xx 

MOUNT INFUT VOLUME 1. ANTI TYPE CRO 

kK BEGIN VERTFICATION xx 

MOUNT INFUT VOLUME 1. AND TYPE CR: 

PRESIIKO? /RQ <———_—_________________- Boot DK@: 


RSTS VO6X-00 SYSTEM #2027 


OFTTIONS 


Figure 3 Sample Run 
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7.0 ERROR MESSAGE SUMMARY 


During the execution of PRESRV, many checks are made by PRESRV to 


determine the success of the operation. 


ERROR MESSAGE 


BITMAP FILE HDR 
READ ERROR 


CONFLICTING SWITCHES 


DEVICE NOT FORMATTABLE 


DEVICE OFFLINE 


DICTIONARY READ: ERROR 


DRIVE NOT READY 


ERROR IN READING COMMAND 


EXPECTED EOF NOT FOUND 


FATAL ERROR ON INPUT 
DEVICE 


MEANING 


An attempt has been made 
to perform a copy in 
FILES-11 mode, but the 
input volume is not in 
FILES-11 format. 


Two conflicting switches 
were specified in the 
command string. For 
example, /TP/FI. 


The specified device is 
not accepted by PRESRV. 
Devices accepted by 
PRESRV for formatting 
are RK03/05, RPO2/03, 
RPO4. 


The specified device is 
not in the configuration 
hardware or the Control 
Status Register (/CSR) 
switch is improperly 
set. 


An error occurred in 
reading a dictionary 
(storage bitmap equiva- 
lent) from logical tape. 


The specified drive is 
not ready or up to speed. 


An error occurred in 
input to the terminal 
or CTRL Z (°Z) was 
illegally typed. 


An End-Of-File (EOF) 
mark was read from the 
input volume but not 
from the output volume 
during the verification 
of a tape image copy. 


An error occurred while 


reading the input volume 
during a tape image copy. 
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RECOVERY 


Retype the command 
using either the 
/IM or /TP switch. 


Specify the correct 
switch(es). 


Specify the correct 
device mnemonic. 
(See Table 1 for 
device names). 


Set the /CSR and 
vector (/VEC) 
addresses for the 
device to the 
proper addresses. 
Retype the command. 


Retry or abort 
the operation. 


Retype command. 


Retry the operation. 


Retry the operation. 


PDP-11 PRESRV USER'S GUIDE 


ERROR MESSAGE 


FATAL ERROR ON OUTPUT 
DEVICE 


HOME BLOCK READ ERROR 


ILLEGAL BLOCK COUNT 


INPUT DEVICE ERROR 
nnnnnnn 


INPUT VOLUME nn. 
SEQUENCE 


OUT OF 


INSUFFICIENT BUFFER SPACE 


LABEL OR BOOTSTRAP 
WRITE ERROR 


LUN ASSIGNMENT ERROR 


NO SUCH FILE 


MEANING 


An error occurred while 
reading or writing the 

output volume during a 

tape image copy. 


An attempt has been made 
to perform a copy in 
FILES-11 mode, but the 
input volume is not in 
FILES-11 format. 


The number of blocks 
specified with the 
switch is 0 or is too 
large for the available 
buffer space. 


An error occurred when 
attempting to read data. 
The octal logical block 
number listed is the 
location where the error 
occurred. 


The number of the input 
volume does not match the 
number of the required 
volume. 


A record on an input 
tape is too large for the 
available buffer space. 


More blocks than are avail- 


able in the buffer are 
needed to complete the 
copy operation. 


An error occurred while 
writing the initial part 
of a logical tape. 


Device or unit combination 


specified in the command 
string is not supported 
by the current PRESRV 
system or is not a valid 
device for PRESRV opera- 
tions. PRESRV recognizes 
only units 0 and 1 unless 
the /UNIT switch is used 
to reassign the reference 
of either 0 or l. 


File named in the command 
string was not found on a 


RECOVERY 


Retry the operation. 


Wait until the 
device is ready or 
retype the command 
using the /IM or 
/TP switch to 
specify the proper 
transfer mode. 


Retry with valid 
block count. (See 
Table 3 for default 
block sizes). 


None 


Mount the proper 
volume and proceed. 


Abort or retry 
the operation. 


Retry or abort 
the operation. 


Determine the 

status of the device 
and type the proper 
command. 


Retype the command 
using a proper 


logical tape, or a magnetic filelabel. 


tape was at End-Of-Volume 
(EOF) for input. 
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OUTPUT DEVICE ERROR 
nnnnnnn 


OUTPUT VOLUME OVERFLOW 


** nnn: -- SELECT ERROR 


STORAGE BITMAP FILE 
READ ERROR 


SYNTAX ERROR 


TAPE LABEL READ ERROR 


TAPE WAS WRITTEN FOR dd 


TRANSFER SPECIFICATION 
MODE ERROR 


VERIFICATION ERROR 
nnnnnnn 


MEANING 


An error occurred in 
reading or writing data. 
The number printed is the 
octal logical block 
number where the error 
was detected. 


Input has more blocks 
than the output volume 
(FILES~-11) can hold. 


Device is off-line. nnn: 
is the specified device. 


An attempt has been made 
to perform a copy in 
FILES-11 mode, but the 
input volume is not in 
FILES~11 format. 


The command string was 
not a valid command. 


An error occurred when 
reading a logical tape 
label record. 


This is a warning 
message not an error 
message. The FILES-11 
volume being restored 
from a logical tape 

is not of the same type 
as the one from which the 
tape was originally made. 
The new volume is given 
the bitmap of the old 
volume. The characters 
dd identify the intended 
FILES~-11 device. 


An inconsistency appears 
in the command string. 
For example, a magnetic 
tape has a /FI switch 
associated with it. 


The data read back from 
the output volume does 
not match what was 
written. The number 
printed is the octal 
logical block number 

on the output device 
where the error was 
detected. 
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RECOVERY 


Retry, continue 
or abort the 
operation. 


Try an alternate 
transfer (for 
example, Image 
Mode). 


Put device on 
line. 


Wait until the 
device is ready 

Or retype the 
command specifying 
the proper transfer 
mode (/IM or /TP). 


Retype the command 
string correctly. 


Retry or abort the 
Operation. 


None 


Retype an 
acceptable 
command. 


Retry, continue 
or abort the 
operation. 


INDEX 


The most important references to subjects are underlined. 


Abort copy operation, see Copy 
operation, abort of 

Abort on I/O Error (/ER) switch, 
8, 14 

ALTMODE key, 13, 14, 20 

Auxiliary command switches, 19 

Auxiliary stand-alone switches, 
see Stand-alone switches 


BEGIN FORMATTING message, 19 
BEGIN VERIFICATION message, 
12, 15, 18 
/BL (Blocking) switch, 8, 16, 
17, 22, 23 
Block 
bootstrap, 2, 12 
buffering, see buffering 
blocks 
definition of, 22 
dummy bootstrap, 2 
information, FILES-11, 5 
logical tape label, 2, 4, 
12 
maximum capacity, 22 
size, 22 
Blocking (/BL) switch, 8, 16, 
17, 22, 23 a 
Blocking factors, default, 
see Default blocking 
factors 
Blocking requirements, 206 
Block-structured devices, l, 
5, 22 
blocking factors, 22, 23 
RFLL/RS11 fixed head disk, 
1 
RH11/RP04 disk pack, 1 
RH11/RS03/RS04 fixed head 
disk, 1 
RH70/RP04 disk pack, 1 
RH70/RS03/RS04 fixed head 
disk, l 
RK1L1/RKO5 cartridge disk, 1 
RP11/RP02/RP03 disk pack, 1 
RX11/RX01 floppy disk, 1 
TC11/TU56 DECtape, 1 
see also specific device 
listings 
/BO (Bootstrap) switch, 9, 28 
Bootstrap, bootstrapping, 2, 
5, 25, 28, 29 
block, 2, 12 
dummy block, 2 
procedures, 6 


Bootstrap (/BO) switch, 9, 28 
Buffering blocks, 6, 14, 15, 16, 
20, 22 
computing required blocks, 20 
disk to magnetic tape, 14, 16 
magnetic tape to disk, 15, 16 
Buffer space, see Buffering 
blocks 


Cassette devices, see Magnetic 
tape devices 
Command (s) 
format, 1 
inspec/switch, 1, 7 
outspec/switch, 1, 7 
used by PRESRV, obtaining list 
of, 6 
see also Switches primary 
command 
Command switches, obtaining list 
of, 6 
CONFLICTING SWITCHES message, 8, 
31 
Control Status Register (/CSR) 
switch, 6, 7, 9, 24, 26 
Copy operations 
abort of, 6, 13, 14, 17, 20, 21 
blocking of, 22 
DECtape to DECtape, 17 
DECtape to disk, 18 


; 
disk to DECtape, 17 


disk to disk, 5, 17 
disk to magnetic tape (TU10), 14 
disk to magnetic tape (TU16), 16 
FILES-11, see FILES-11 mode 
identical media, 1, 11, 17 
image mode, see Image mode 
logical tape, see Logical tape 
mode 
magnetic tape (TU10) to disk, 
15 
magnetic tape (TU16) to disk, 
16 
Magnetic tape (TU10) to magnetic 
tape (TU10), 17 
magnetic tape (TU16) to magnetic 
tape (TU16), 17 
multi-volume files, 2 
non-identical media, 5 
verification of, 12, 14, 15, 16, 
18, 21 
Core-dump mode, 28 
CSR address, 24, 25 
/CSR (Control Status Register) 
switch, 6, 7, 9, 24, 26 


Index-1 


INDEX (Cont.) 


Date default, 27 

Decimal point, trailing, 23 
DECtape, 1, 13, 17, 18, 23 
Default blocking factors, 

14 - 19, 20 - 23 
DECtape requirements, 23 
disk to disk, 17 
disk to magnetic tape, 14, 

16 
Magnetic tape to disk, 15, 

16 


Magnetic tape to magnetic 
tape, 17 
table of, 22 
Default Blocking Factors (/BL) 
switch, 22, 
Default block size, 22 
trailing decimal point, 23 
Default (s) 
block-structured devices, 5 
FILES-11, 11, 14 
tape devices, 5 
time and/or date, 27 
used by PRESRV, obtaining 
list of, 6 
Density, tape, 9, 28 
DEVICE NOT FORMATTABLE message, 
19 
DEVICE NOT READY message, 7 
DEVICE OFFLINE message, 31 
Devices 
block-structured, 1, 5, 22 
block-structured, list of, 1, 
see also Block-structured 
devices 
classes, 1 
CSR address, 24, 25 
directory listing, obtaining, 
26 
mounting, 6 
Support, 1 
tape, 1, 5, 23 
tape, list of, 1, see also 
Magnetic tape devices 
vector address, 24 
verification, 6, 12 
Device-specific switches 
setting density to 200 bpi 
(/20), 9, 28 
setting density to 556 bpi 
(/55), 9, 28 
setting density to 800 bpi 
(/80), 9, 28 
DICTIONARY READ ERROR message, 
31 
DISABLE FORMATTING WITH SWITCH 
ON CONTROLLER. TYPE CR 
WHEN READY message, 19 


Disk devices, see Block- 
structured devices 

Disk restoration, 12, 15, 16, 18 

Disk to DECtape copy operation, 
17 

Disk to disk copy operation, 17 

Disk to magnetic tape (TU10) copy 
Operation, 14 

Disk to magnetic tape (TU16) copy 
operation, 16 

DRIVE NOT READY message, 31 

Dummy bootstrap block, 2 


ENABLE FORMATTING WITH SWITCH ON 
CONTROLLER. TYPE CR WHEN 
READY message, 19 

END FORMATTING message, 19 

End-of-file tape mark, 2, 17 

EOF (end-of-file) tape mark, 2, 17 

7ER (Abort on I/O Error) switch, 
14 


ERROR IN READING COMMAND message, 
31 

Error, I/0, 8, 13, 14 

Error message summary, 31 - 33 

EXPECTED EOF NOT FOUND message, 31 


FATAL ERROR ON INPUT DEVICE 
message, 31 
FATAL ERROR ON OUTPUT DEVICE 
message, 32 
Faulty volume, 13 
/FI (FILES-11 mode) switch, 10, 13 
Filelabel 
definition of, 2 
printing list of, 10 
use of, 2, 4, 7, 11, 14 - 18, 25 
FILES-11 mode, 1, 5 
default, 11, 14 
information blocks, 5 
FILES-11 mode (/FI) switch, 10, 13 
Files, multi-volume, 2 ae 
/FO (Formatting Disk) Switch, 5, 
10, 19 
Format ~—_ 
command, 1 
device, 7 
logical tape, 3 
Format Enable/Normal switch, 19 
Formatting disk (/FO) switch, 5, 
10, 19 
Formatting RPO2 or RPO3 disk, 19 
Functions of PRESRV, 5 


Index-2 


INDEX (Cont.) 


Hardware specific switches 
/CSR, 6, 7, 9, 24, 26 
/TMO2, 10, 25, 26 
/UNIT, 10, 26 
/VEC, 7, 10, 24 - 26 
HELP (/HE) command, 6, 10 
HOME BLOCK READ ERROR message, 
32 


IAS system, 5 

Identification, sector, 19 

Identification, timing, 19 

ILLEGAL BLOCK COUNT message, 
22, 32 

Image mode, 1, 2, 5, 11, 13, 
17, 21 

Image mode (/IM) switch, 10, 
11, 12, 14, 16, 17, 18 

/IM (Image Mode) switch, 10, 
il, 12, 14, 16, 17, 18— 

Information blocks, FILES-11, 5 

INPUT DEVICE ERROR message, 32 

INPUT VOLUME 2 OUT OF SEQUENCE 
message, 16, 32 

Inspec, modification of, 7 

Inspec/switch, 1, 7 

INSUFFICIENT BUFFER SPACE 
message, 6, 32 

I/O error, 8, 13, 14 


Label block, 2, 12 
Label block, logical tape, 4 
LABEL OR BOOTSTRAP WRITE ERROR 
message, 32 
/LI (Listing) switch, 10, 26 
Listing (/LI) switch, 10, 26 
Location 522, 7 aa 
Logical tape 
format, 3 
label block, 4 
mode, 1, 2 
(/TP) switch, 12 
Logical tape devices, see 
Magnetic tape devices 
Logical Tape mode (/TP) switch, 
8, 12, 17, 18, 21 
LUN ASSIGNMENT ERROR message, 
32 


Magnetic tape 
(TULO) to disk copy operation, 
15 
(TUL6) to disk copy operation, 
16 


Magnetic tape (cont.) 
(TU10) to magnetic tape (TU10) 
copy operation, 17 
(TU16) to magnetic tape (TU16) 
copy operation, 17 
Magnetic tape devices, 1 
blocking factors, 22, 23 
RH11/TM02/TU16 magnetic tape 
(9-track), l 
RH70/TM02/TU16 magnetic tape 


(9-track), 1 
see also specific device 
listings 


TA11/TU60 cassette, 1 
TM11/TSO3 magnetic tape (9- 
track), 1 
TM11/TU1LO magnetic tape (7- or 
9-track), 1 
Massbus peripherals, mixed, 26 
Media, non-identical, 5 
Memory requirements, PRESRV, 22 
Messages 
BEGIN FORMATTING, 19 
BEGIN VERIFICATION, 12, 15, 18 
CONFLICTING SWITCHES, 8, 31 
DEVICE NOT FORMATTABLE, 19, 31 
DEVICE NOT READY, 7, 31 
DEVICE OFFLINE, 31 
DICTIONARY READ ERROR, 31 
DISABLE FORMATTING WITH SWITCH 
ON CONTROLLER. TYPE CR WHEN 
READY, 19 
DRIVE NOT READY, 31 
ENABLE FORMATTING WITH SWITCH 
ON CONTROLLER. TYPE CR WHEN 
READY, 19 
END FORMATTING, 19 
ERROR IN READING COMMAND, 31 
error, summary, 31 - 33 
EXPECTED EOF NOT FOUND, 31 
FATAL ERROR ON INPUT DEVICE, 31 
FATAL ERROR ON OUTPUT DEVICE, 32 
HOME BLOCK READ ERROR, 32 
ILLEGAL BLOCK COUNT, 22, 32 
INPUT DEVICE ERROR nnnnnnn, 32 
INPUT VOLUME 2 OUT OF SEQUENCE, 
16, 32 
INSUFFICIENT BUFFER SPACE, 6, 
15, 32 
LABEL OR BOOTSTRAP WRITE ERROR, 
32 
LUN ASSIGNMENT ERROR, 32 
MOUNT INPUT VOLUME 1 AND TYPE 


CR, 15, 18 

MOUNT INPUT VOLUME 2 AND TYPE 
CR, 15 

MOUNT OUTPUT VOLUME 1 AND TYPE 
CR, 15, 18 
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Messages (cont.) 
NO SUCH FILE, 7, 15, 18, 32 
OUTPUT DEVICE ERROR nnnnnnn, 
33 
PRESRV identification, 6 
STORAGE BITMAP FILES READ ERROR, 
5, 33 
SYNTAX ERROR, 23, 33 
TAPE LABEL READ ERROR, 33 
TAPE WAS WRITTEN FOR dd, 33 
TRANSFER SPECIFICATION MODE 
ERROR, 17, 33 
VERIFICATION ERROR nnnnnnn, 
12, 33 
VOLUME FAULTY - "R" TO RETRY, 
"Cc" TO CONTINUE, 13, 14 
Mixed Massbus peripherals, 26 
Mode 
core-dump, 28 
FILES-11, 1, 5 
image, 1, 2 . 
logical tape, 1, 2 
Modifying switch, 7 
Monitor restoration, 28 
Mounting device, 6 
Multi-volume files, 2 


Non-identical media, 5 

Normal vector, 24, 25 

NO SUCH FILE message, 7, 15, 
18, 32 


Option switches, list of, 8 - 11 

OUTPUT DEVICE ERROR nnnnnnn 
message, 33 

OUTPUT VOLUME OVERFLOW 
message, 33 

Outspec, modification of, 7 

Outspec/switch, 1, 7 

Overriding default blocking 
factors, 23 


/PE (Phase-Encoded tape) 
switch, 2, 9, 12, 16, 17, 
26 

Peripherals, mixed Massbus, 26 

Phase-Encoded tape (/PE 
switch), 2, 9, 12, 16, 
17, 26 

Physical tape, 4 

Physical unit number, 10, 26 

Positioning tapes, 2 


PRESRV 

commands, 1 

description of, 1 

devices supported by, l 

functions, 

identification message, 6 

memory requirements, 22 

services, 5 

services, to print summary of, 
10 

use of, 6 

Primary command switches, 11 

Abort on I/O Error (/ER), 14 

FILES-11 mode (/FI), 13 

Image Mode (/IM), 11 

Logical Tape Mode (/TP), 12 

Phase-Encoded tape (/PE), 12 

Rewind at Completion (/RW), 
13 

Verification (/VE), 12 


Restoring disk 
from DECtape, 12, 18 
from magnetic tape (TU10), 15 
from magnetic tape (TU16), 16 
Restoring the Monitor (/BO) 
switch, 28 
Rewind at completion (/RW) switch, 
8, 13 
RH controller, 25, 26 
RKOS disk cartridge, 1, 10, ll, 
14, 15, 18, 19 
RPO2 disk, 1, 10, 15, 19 
RP03 disk, 1, 10, 15, 19 
RP03 disk drive, 1, 10, 15, 19 
RP02/RP03 disk formatting, 19 
RP04 disk pack, 1, 6, 10, 12, 15, 
19, 25, 26 
RP11 controller, 19 
RSTS/E system, 28 
RSX-11D system, 5 
RSX-11M system, 5 
RSX-11S executive, 6 
/RW (Rewind at Completion) switch, 
8, 13 


Sample run, 28 

Sample run, (Fig.), 30 

Sector identification, 19 

SELECT ERROR message, 33 

Services of PRESRV, 5 
printing summary of, 10 

Setting density to 200 bpi 

(/20) switch, 9, 28 


Index-4 


INDEX (Cont.) 


Setting density to 556 bpi 


(/55) switch, 9, 28 
Setting density to 800 bpi 
(/80) switch, 9, 28 


Stand-alone switches 


/BO, 28 
/HE, 6, 10 
/LI, 26 
/TIM, 9, 27 


STORAGE BITMAP FILES READ 


ERROR message, 5, 33 


Switches 


Abort on I/O Error (/ER), 
8, 14 

Auxiliary command, 19 

Blocking, (/BL), 8, 14, 16, 
17, 22, 23 

Bootstrap (/BO), 9, 28 

Control Status Register 
(/CSR), 6, 7, 9, 24, 26 

Device specific, 9, 28 

see also Device amcl Fie 
switches 

FILES~1l1 mode (/FI), 10, 13 

Format Enable/Normal, 19 

Formatting Disk (/FO) , 5 5, 
10, 19 

Hardware specific, 23, see 
also Hardware specific 
switches 

Help command (/HE), 6, 10 

Image Mode (/IM), 10, 11, 
12, 14,.16, 17, Te ~~ 

Listing (/LI), 10, 26 

Logical Tape Mode (/TP), 
8, 12, 17, 18, 21 

Modifying, 7 

Phase-Encoded Tape (/PE), 
2, 9, 12, 16, 17, 26 


Primary command, 11, see also 


Primary command switches 

Restoring the Monitor (/BO), 
28 

Rewind at Completion (/RW), 
8, 13 

Setting density to 200 bpi 
(/20), 9, 28 

Setting density to 556 bpi 
(/55), 9, 28 

Setting density to 800 bpi 
(/80), 9, 28 

Stand-alone, auxiliary, 26, 
see also Auxiliary stand- 
alone switches 

Time and Date (/TIM), 9, 27 

TMO2 Formatter (/TM02), 10, 
25, 26 


Switches (cont.) 
Unit (/Unit), 10, 26 
Vector (/VEC), 7, 10, 24, 26 
Verify (/VE), 11, IZ, If, 16, 
17, 18, 20, 21 
Switches, list of, 8 - 11 
SYNTAX ERROR message, 23, 33 
System crash, 7 


Systems 
TAS, 5 
RSTS/E, 28, 29 
RSX-11D, 5 
RSX-11M, 5 
Tape, 


density, 9, 28 
logical label block, 4 
logical mode, 1, 2 
mark, end-of-file, 2, 17 
Phase-Encoded (/PE) switch, 2, 
9, 12, 16, 17, 26 
physical, 4 
positioning, 2 
Tape devices, see Magnetic tape 
devices 
TAPE LABEL READ ERROR message, 33 
TAPE WAS WRITTEN FOR dd message, 
33 
Time default, 27 
Time (/TIM) switch, 9, 27 
Timing identification, 19 
/TIM (Time) switch, 9, 27 


TMO2 tave formatter 10 95 26 


nae APN EI E EEL py tp oy 
/TMO2 (TMO2 formatter) switch, 
10, 25, 26 
/TP (Logical Tape Mode) switch, 
8, 12, 17, 18, 21 
Trailing © decimal point, 23 
TRANSFER SPECIFICATION MODE 
ERROR message, 33 
TSO3 magnetic tape device, 1, 2 
TU1O magnetic tape drive, 1, 2, 9, 
14, 15, 17, 28 
TU16 magnetic tape drive, l, 2, 9, 
12, 16, 17, 21, 25, 26 


Unit number, physical, 7, 10, 26 
Unit (/Unit) switch, 10, 26 


Vector addresses 
list of, 24 
Vector address (/VEC) switch, 7, 
10, 24, 26 
Vector, normal, 24, 25 
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/VEC (Vector Address) switch, 7, Write error, 14 
10, 24, 26 Write-ring, ll 
Verification (/VE) switch, ll, 
12, 14, 16, 17, 18, 20, al 
Verification of copy operation, 
see copy operations, 
verification of 
VERIFICATION ERROR nnnnnnn 
message, 12, 33 
Verification failure, 12 
/VE (Verification) switch, ll, 
12, 14, 16, 17, 18, 20, 21 
VOLUME FAULTY - "R" to RETRY, 
"C" to CONTINUE message, 
13, 14 
Volume number error, 16 
Volumes, multi-volume files, 2 
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READER'S COMMENTS 


NOTE: This form is for document comments only. Problems 
with software should be reported on a Software 
Problem Repert (SPR) form. 


Did you find errors in this manual? If so, specify by page. 


Did you find this manual understandable, usable, and well-organized? 
Please make suggestions for improvement. 


Is there sufficient documentation on associated system programs 
required for use of the software described in this manual? If not, 
what material is missing and where should it be placed? 


Please cut a 


Please indicate the type of user/reader that you most nearly represent. 


Assembly language programmer 
Higher-level language programmer 
Occasional programmer (experienced) 
User with little programming experience 
Student programmer 
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Non-programmer interested in computer concepts and capabilities 
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Country 
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